home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / mnubt300.zip / MENUBOOT.DOC < prev    next >
Text File  |  1993-03-02  |  35KB  |  889 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                ╔═════════════════════════════╗
  25.                     ║     MENUBOOT.SYS  V3.00     ║
  26.                ║ (c)  1992, 1993 P. Appleton ║
  27.                ║  Graphics handling routines ║
  28.                ║      (c) 1993 A. Brown      ║
  29.                ╚═════════════════════════════╝
  30.  
  31. Page 2
  32.             Contents
  33.  
  34. Introduction.................................................3
  35. Registration / License agreement.............................4
  36. Installation.................................................5
  37. Basic usage..................................................5
  38. Use of the command line interpreter..........................6
  39. Multiple menus...............................................8
  40. Use of the 'SET' command.....................................9
  41. Use of the 'NONRES' command.................................11
  42. Use of the ON and OFF commands..............................11
  43. Use of the BLANK command....................................12
  44. Appendix 1 - New DEVICE statements..........................13
  45. Appendix 2 - Error messages.................................16
  46. Appendix 3 - System requirements / known problems...........17
  47. Revision history / future plans.............................18
  48. Disclaimer..................................................19
  49.  
  50. NB:  Versions 3.00+ require a VGA card to run.  Not having a VGA
  51. will cause the program to abort!
  52.  
  53. Version 2.52 is the last version which will run on one of these cards,
  54. and is available instead of version 3.00 at the same price.
  55.  
  56. Page 3
  57.             Introduction
  58.  
  59.  
  60. With the variety of modern software and hardware now available,
  61. inevitably conflicts arise between the configurations required
  62. for different programs.  MS-DOS only allows for one
  63. configuration file to be present, and hence can lead to some
  64. extraordinary manipulations using batch files to allow
  65. configurable rebooting.
  66.  
  67. MENUBOOT is a device driver which adds new commands to your
  68. CONFIG.SYS file enabling you to simply and easily build custom
  69. menus, obviating the requirement to swap configuration files.
  70. Commands are provided to allow the user's choice to be saved for
  71. later use by other programs or AUTOEXEC.BAT.  The following
  72. features are provided:
  73.  
  74.  
  75. Up to 20 options per menu.
  76.  
  77. Up to 255 menus (!).
  78.  
  79. User-defined menus, with selection by cursor keys or initial
  80. letter.
  81.  
  82. Optional default and/or timeout for each menu.
  83.  
  84. User definable colours.
  85.  
  86. Cursor positioning commands.
  87.  
  88. Box drawing commands.
  89.  
  90. Uses typically 280-300 bytes of memory (optionally uses none, see
  91. page 11 DEVICE=NONRES).
  92.  
  93. Ability to communicate with other programs via environment variables.
  94.  
  95. Graphical interface (requires VGA card or better).
  96.  
  97. Ability to suppress ALL output from device drivers as they load.
  98.  
  99. Ability to process menu from config.sys from command line, allowing 
  100. easy designing of menus without requiring a reboot.
  101.  
  102. Page 4
  103.         Registration / License agreement
  104.  
  105. MENUBOOT.SYS is shareware.  That means that you are permitted to
  106. use a unregistered copy freely for a 'reasonable time', and to
  107. freely distribute unregistered copies, provided that all the
  108. files making up this package are included and that MENUBOOT.SYS
  109. is not bundled with any other package or product whatsoever.
  110. You may not, for any reason whatsoever, distribute, sell, lend
  111. or otherwise transfer or permit to be transferred any registered
  112. copy of MENUBOOT.SYS, nor may you charge for an unregistered
  113. copy apart from a nominal fee to cover the costs of duplication,
  114. distribution and handling.  You are not permitted to
  115. disassemble, decrypt or modify MENUBOOT.SYS or any portion
  116. thereof.  No registered copy of MENUBOOT.SYS may be installed on
  117. more than one computer, unless there is NO possibility that two
  118. or more of these computers may be running at the same time.  If
  119. you use MENUBOOT.SYS after a short (1 month) trial period, you
  120. MUST register.  MENUBOOT.SYS shall remain at all times the
  121. property of the author; you are permitted a limited license to
  122. use MENUBOOT.SYS.  By installing MENUBOOT.SYS onto your machine
  123. you indicate your acceptance of the above terms and conditions.
  124.  
  125. Registration is available by payment of £15 to:
  126. P. Appleton
  127. Greenaway
  128. Maltmans Lane
  129. Gerrards Cross
  130. Bucks SL9 8RT
  131. England
  132.  
  133.  
  134. This will entitle you to the benefits of:
  135.  
  136. Free support by mail / email of MENUBOOT.SYS.
  137. Unlimited free upgrades (please send a disk and P&P).
  138. No 'nag' text or similar items.
  139.  
  140. In addition, a professionally printed and bound manual is availble for
  141. an extra £5 to registered users only (it is significantly better laid
  142. out than this one...).
  143.  
  144. If you have an urgent problem, you can also ring me at 0742-308830
  145. although I cannot guarrantee how long this number will be unchanged,
  146. or preferrably email me as:
  147.  
  148. bi3pma%stg1.shef@sunc.shef.ac.uk  (Internet).
  149.  
  150. Email is the fastest, easiest and (for me) prefferable way to contact me
  151. on the whole.
  152.  
  153. Page 5
  154.             Installation
  155.  
  156.  
  157. Installation of MENUBOOT.SYS is extremely simple.  You should
  158. have received three large files - MENUBOOT.DOC (which you're reading),
  159. MENUBOOT.EXE, and MENUTEST.EXE -  and several small utilities / bits & 
  160. bobs.  The documentation can either be printed or left for on-line 
  161. reference if preferred, and the other files should all be copied to a
  162. sub-directory.  MENUBOOT.SYS is now a slight misnomer as it has been
  163. repackaged in an EXE format; this allows the three previous programs to
  164. be incorporated into a single file, although it does mean losing
  165. backwards compatability with MS-DOS 2.x.  If you run version 2.0 (!),
  166. either:
  167.  
  168. a) Upgrade to at least MS-DOS 3.30
  169. b) Use MENUBOOT.SYS version 1.x
  170.  
  171. To start using MENUBOOT.SYS two changes are required to your
  172. CONFIG.SYS file:
  173.  
  174.  A new line should be inserted at the begining with the
  175. statement DEVICE=[path]MENUBOOT.EXE
  176.  
  177.  A new line must be inserted at the end with the statement
  178. DEVICE=~ (found as shift-# on UK keyboards).
  179.  
  180.  
  181. That's it!  At the moment, it will not do anything terribly
  182. useful, but it will provide all the new commands.  The use of
  183. MENUBOOT to provide menus is covered in the next section.
  184.  
  185.             Basic usage
  186.             -----------
  187.  
  188. First, a word on syntax conventions in this manual.
  189.  
  190. Anything enclosed in [square braces] is optional, and may be
  191. ommitted or replaced with the relevant parameter; hence [path]
  192. may be ommitted or replaced with (for example) C:\PDUTILS\.
  193.  
  194. Anything enclosed in <angle braces> is literal, and must be
  195. entered exactly as-is.  Also, all text not enclosed in braces is
  196. a literal.
  197.  
  198. Anything enclosed in {curly braces} is a required parameter, and
  199. should have the appropriate argument substituted for the text in
  200. the curly braces.
  201.  
  202. The pipe symbol | indicates a choice of items; for example,
  203. [MAX|OPTION|{number}] indicates that you may omit the parameter,
  204. supply a number or one of the parameters MAX or OPTION.
  205.  
  206. OK, so, what is the format for a menu?
  207.  
  208. A menu is started by the line:
  209.     DEVICE=MENU [options]
  210. (Note: see appendix 1 for an explanation of all the options you
  211. may use)
  212.  
  213. Page 6
  214.  
  215. When this line is encountered, MENUBOOT will clear the screen,
  216. display a copyright notice and any text or options you specify,
  217. and then wait for you to choose an option (or press a key if no
  218. options were specified).  An option is specified by the line:
  219.  
  220.     DEVICE=OPTION [<{>{options}<}>] {option text}
  221.  
  222. In between the OPTION statements, any configuration statements
  223. relevant to that option should be placed.
  224.  
  225. Finally, the menu is terminated by the line
  226.     DEVICE=END
  227. We now know enough to create a simple menu sytem for a sample
  228. CONFIG.SYS file:
  229.  
  230. DEVICE=C:\PDUTILS\MENUBOOT.EXE
  231. DEVICE=MENU
  232. DEVICE=OPTION 1...I^NSTALL RAMDRIVE^
  233. DEVICE=C:\DOS\RAMDRIVE
  234. BUFFERS=5
  235. DEVICE=OPTION 2...D^ON'T INSTALL RAMDRIVE
  236. BUFFERS=15
  237. DEVICE=END
  238. DEVICE=C:\DOS\ANSI.SYS
  239. FILES=30
  240. DEVICE=~
  241.  
  242. Try it!  Format a blank disk, making sure you transfer MS-DOS
  243. and MENUBOOT.EXE, and type it in as your CONFIG.SYS.  Alternatively, you 
  244. can dipslay it from the command line, without needing to reboot, by just 
  245. typing 'MENUTEST' which will invoke the command-line interpreter.  Note 
  246. that at present this is a very si